home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / boyan51b.zip / SCRIPT.DOC < prev   
Text File  |  1993-11-15  |  19KB  |  441 lines
  1. Most scripts are provided - by Lee Breeden
  2.  
  3. This script is offered AS IS with all its flaws, as an example of the
  4. many different options available with BOYAN script language. There are no
  5. warranties, express or implied.  This is the efforts of my time, as well
  6. as others who have tried, tested, modified and corrected spelling <G> to
  7. make this what it is.
  8.  
  9. This idea was inspired by Kendall D'Andres, and help from Paul Buerkle.
  10.  
  11. The new scripts contain a new feature called SMART script, which will
  12. allow you to have inter-action with a remote system while the script is
  13. running and then return control back to the script.  It will also allow
  14. you to abort the script the script and allow it to RESUME where it left
  15. off......
  16.  
  17. New script has improved file transfers, supports BBSee15 for
  18. handling filenames using QWK newfiles.dat info.
  19.  
  20. Now supports RoseMail!
  21.  
  22. These are a few scripts that will make a system script that will set all of
  23. the variables necessary for calling a system for mail, and file functions.
  24.  
  25. It is self explanatory to generate the script, but there are some things
  26. that will need to be modified in your current boyan.mac file for all of
  27. this to work.
  28.  
  29. The files contained are:
  30.  
  31.  ° Readme.txt  -  this file
  32.  
  33.  ° Script.bsc  -  this contains all of the commands that will be used to
  34.                    run the system script.
  35.  
  36.  ° Makemail.bsc - is the file that you will need to run that makes the
  37.                    system script for you.
  38.  
  39.  ° Nite.bsc     - is a sample of my own script that I use to start calling
  40.                    all of the systems that I call.
  41.  
  42.  ° Boy.mac      - this is my own macro file that I use on my system. If
  43.                    you would like to look at it, I would suggest
  44.                    that you rename your own  boyan.mac file  and then ren
  45.                    boy.mac to boyan.mac and look at mine.
  46.                    If you do, you might need to make the following changes
  47.                    if you plan on trying to use it:
  48.                       a) modem init string. macro #9
  49.                       b) macro #1 has commands for call waiting.
  50.  
  51. Script LIST:
  52.  
  53.  °  end      bsc   This is a nice script that I run after disconnecting
  54.                    from a system (Macro #7), it displays the time and
  55.                    lenght of connection from the last call
  56.  
  57.  °  gt-power bsc   Logon script for GTComm boards
  58.  
  59.  °  makemail bsc   MAIL Script generator
  60.  
  61.  °  nite     bsc   Sample unattended nite mail setup script
  62.  
  63.  °  pcboard  bsc   Logon script for PCBoards
  64.  
  65.  °  qefiles  bsc   Filename grabber script.
  66.  
  67.  °  quote    bsc   Message quote macro
  68.  
  69.  °  rbbs     bsc   Logon script for RBBS boards
  70.  
  71.  °  script   bsc   Main script for mail calls
  72.  
  73.  °  start    bsc   Startup script for setting log file by date
  74.  
  75.  °  wildcat  bsc   Logon script for WildCat boards
  76.  
  77.  
  78. Purpose:
  79.  
  80.    This program is to aid anyone interested in calling systems unattended
  81. for mail and file transfers to PCBoard systems. All of this is will be
  82. done with Boyan scripts.  Even the process of creating a script will be
  83. done with a Boyan script.
  84.  
  85. Getting started:
  86.  
  87. First place all of the *.bsc files in the boyan script file directory.
  88. Next hit ALT-R and delete anything on the status line, followed by <CR>.
  89. Highlight the script called makemail.bsc and hit <cr>.
  90.  
  91.        You will need to have the following handy to complete the script.
  92.  
  93.          °  Name to call the script.
  94.          °  Type of door for mail.
  95.          °  Door number.
  96.          °  Name of system mail packets for both up and downloads.
  97.          °  The number of mail packets that you wish to keep.
  98.  
  99. The script called MailMake.bsc will check for your first and last name in
  100. macros #111 and #112. If not contained there, it will ask you for your
  101. first and last name. Then it will install them in 111 and 112 for you. The
  102. next time that you run MakeMail it will display your first and last name
  103. on the screen and ask if this is correct.
  104.  
  105. It will be displayed as Lee ` Breeden
  106.  
  107. the back quote character, one character after your first name MUST be
  108. there for all of this to work.
  109.  
  110. The script will then check to see if you have a defined password in the
  111. setup. If not it will ask you to install one. The rest of the script will
  112. be question and answer of the above questions. All of this information
  113. will be stored in your user defined script name.
  114.  
  115. Operation of the script.
  116.  
  117. Once you have created the User defined script, it will set all of the
  118. variables that will be needed for the call. All of the variables will be
  119. used in the script call SCRIPT.bsc. This way, if there are any changes in
  120. the mail door(s). A new script.bsc file can be easily replaced for the
  121. existing one without having to changes to the related commands for the
  122. system.bsc.
  123.  
  124. Here is what your system script should look like:
  125.  
  126. \\ This script automates Mail runs to EDSHOME Bulletin Board.
  127. \\ You must set the following macros with BOYAN's configuration module:    
  128. \\  \! = Macro # 111 = Your first name                                     
  129. \\  \@ = Macro # 112 = Your last name                                      
  130. \\  %PW = Is your defined password.                                      
  131. \\  \sv1 used for mail system report file *.rep.                           
  132. \\  \sv2 used for prodoor option number.                                   
  133. \\  \sv3 used for mail door option number.                                 
  134. \\  \sv4 used for mail packet system name *.qwk.                           
  135. \\  \sv5 used for up-file name or names.                                   
  136. \\  \sv6 used for file upload description.                                 
  137. \\  \sv7 used for file upload description, leave blank if not used         
  138. \\  \sv8 used for file upload description, leave blank if not used         
  139. \\  \sv9 used for file upload description, leave blank if not used         
  140. \\  \sv0 used for system name in call back option.                       
  141. \\  \svA used to set option for call back block.                           
  142. \\  \svB used for setting number of mail packets to keep.                  
  143. \\  \svC used for setting file scan option <U>pload <A>ll etc.             
  144. \\  \svD used internally to read variable        
  145. \\  \svE used internally for selection option                              
  146. \\  \svF used for setting cursor position in mail door.                   
  147. \\  \svG used for setting the maximun number of messages in mail door.     
  148. \\  \svH used for setting timer to wait for no messages prompt in mail door.
  149. \\ Need to have in boyan macro #7 \AT+[\qd]
  150. \\  as last command.                                                       
  151. \\Script assumes that you put your message replies in upload dir.           
  152. \\Script assumes that you put your messages packets in DN dir.             
  153. \\Script assumes that you use Zmodem configured as Z.                      
  154.                                                                            
  155. |LOGON                                    \\ Start script blocks    
  156. \IE+OFF,%LD[\LD+]                         \\ Turn on Log to disk file  
  157. \SV0[%SN]            \\ set existing system number to %v0
  158. \sv1[EdsHome.rep]    \\ Report packet name
  159. \SV2[1]              \\ enter door number [#]
  160. \sv4[EdsHome.qwk]    \\ Mail Packet name
  161. \SV5[boydoc50.zip ]  \\ Name of file to UpLoad
  162. \SV6[Great boyan script for viewing portions ]\\ file description
  163. \SV7[of the boyan 5.0 manual. Has menu and   ]\\ file description
  164. \SV8[table of contents.  By Paul Buerkle     ]\\ file description
  165. \SV9[          ]    \\ enter file name to download
  166. \SVB[9]             \\ enter number of qwk's to keep
  167. \SVC[a]             \\ scanning directories for files A all or U uploads
  168. \SVF[35]            \\ Cursor position
  169. \SVG[800]           \\ Maximum message counter for mail
  170. \SVH[1]             \\ Timer to wait for NO messages 2-15 sec
  171.                                                                            
  172. \DM[CONNECTED TO %SN]                     \\ System display message    
  173. \to[40]\pl                                \\ Set timer                 
  174. \\CA-[\eb]                                \\ Check carrier currently off
  175. \CA+[\SC[SCRIPT;NAME]]                    \\ Enter name block        
  176. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors          
  177. \CA+[\SC[SCRIPT;QUEST]]                   \\ Question block
  178. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors          
  179. \CA+[\SC[SCRIPT;mail]]                    \\ Mail block
  180. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  181. \CA+[\FE+%u:%V1[\SC[SCRIPT;QMul]]]        \\ Upload block
  182. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  183. \CA+[\SC[SCRIPT;QMdl]                     \\ Mail download
  184. \ie+%VA,X[\gs[script;calback]\eb]         \\ Checking for errors
  185. \CA+[\SC[SCRIPT;FILES]]                   \\ Scan for new files block
  186. \\CA+[\FE+%U:%V5[\SC[SCRIPT;upload]]]     \\when doing upload or download remove
  187. \\CA+[\FE-%D:%V9[\SC[SCRIPT;download]]]   \\slash from beginning of line
  188. \CA-[\AB]\CA+[\gs[SCRIPT;Logoff]]         \\ Log off block
  189. \ab
  190.  
  191.  
  192. Extra Tips:
  193.  
  194.   I use a separate phone directory for calling systems at nite.  The
  195. reason being, is that the delete option in the phone directory can fowl up
  196. the order that the phone numbers are in, thus causing you some problems.
  197. You can use the clone fon option in the dialing directory to easily create
  198. a nite.fon file, and delete the entries that you don't use.
  199.  
  200. I have a path for the log files off of the boyan directory, called \log.
  201. There is also a file called start.bsc that is called from macro #9 that
  202. sets the current date of the log to disk file.  Each time the nite.bsc
  203. file runs it deletes one log file, keeping the last five of them.
  204.  
  205. If you run into any problems related to the doors or the script(s), I can
  206. be reached on any Boyan conference that you can find. I currently host the
  207. Boyan conference on the following nets: Rime, Ilink, SmartNet and U'NInet.
  208. Comments welcome.  I support the Boyan 5.0 program for Justin, and I
  209. answer the order line up until 10:00pm EST.  (301)805-7168  If you need
  210. help just yell..... not too loud... <g>.
  211.  
  212. If you are using one of these scripts and having some difficulties with
  213. one or any of them, please let me know.  I will be running the Boyan
  214. support line from 10pm(Nite) to 2am(morning) EST for the latest release.
  215. If you have any ideas, or suggestion, I would be happy to hear of them.
  216.  
  217.  
  218. New SMART script features:
  219.  
  220. This is something totally different from anything that I have done with
  221. the script language before.   These scripts will allow the user to leave
  222. the script running and have inter-action with the remote system.  When
  223. your thru you can resume the script where you left off.  Your even able to
  224. abort the script and have it restart at the last place (block) that you
  225. left off at........ IMPRESSIVE....hum.....
  226.  
  227. QUICK Start.  Install all of the files in the script directory.
  228.  
  229. I had to change the file that is called script.bsc.  It would be a good
  230. idea to MAKE A BACKUP copy of the SCRIPT.bsc just incase you have some
  231. problems with this script.   Run the MakeMail.bsc file.   The easiest way
  232. to do this is to hit Alt-R and highlight the file and then go thru the
  233. questions to create a script.
  234.  
  235.  
  236. Using the New features.
  237. You run the scripts in the same manor as before.  You will have a status
  238. line message that says "Hit <TAB> for Menu options" (see below).
  239.  
  240.  
  241. ╔═══════════════════════════════════════╗
  242. ║ OnLine MENU    %HR:%MI  %Mo/%DA/%YR   ║
  243. ╠═══════════════════════════════════════╣
  244. ║ <C> = find main Command               ║  ->   this command  was removed  from
  245. ║ <D> = Download a file                 ║       this menu but the command is
  246. ║ <DM>= Download Mail (from mail door)  ║       still active.
  247. ║ <E> = Edit Script                     ║
  248. ║ <F> = File Manager                    ║
  249. ║ <G> = Goodbye                         ║
  250. ║ <J> = Jump to DOS                     ║
  251. ║ <L> = Log to disk ...status %LD       ║
  252. ║ <M> = Mail (check for your mail)      ║
  253. ║ <N> = New File Scan                   ║
  254. ║ <O> = Open Door                       ║
  255. ║ <P> = edit Phone directory            ║
  256. ║ <Q> = Quick Note file                 ║
  257. ║ <R> = RESUME Script                   ║
  258. ║ <S> = Scroll-back buffer              ║
  259. ║ <T> = Terminal Mode                   ║
  260. ║ <U> = Upload a file                   ║
  261. ║ <UM>= Upload Mail (from mail door)    ║
  262. ╟───────────────────────────────────────╢
  263. ║ <R> = RESUME Script  <?> Manual Macro ║
  264. ║<Esc>= ABORT script   <V>iew Settings  ║
  265. ╚═══════════════════════════════════════╝
  266.  
  267. At this point you can choose anything on the menu <g>.....
  268. To start inter-active mode hit  "T"erminal mode.  At this point you can
  269. enter commands online with the remote, make changes, chat with sysop
  270. etc.... and then hit <TAB> and then "R"esume to start where you left off.
  271.  
  272. Whoops.....! hit the ESC button.... darn.... But guess what..... New
  273. SMART script feature will allow you to re-start the script and start where
  274. it left off as well......(look out Chuck.... resume too...!)
  275.  
  276. ReSTART script:
  277. To use this feature you need the start the script with this macro key
  278. configured somewhere to your liking.
  279.  
  280. \SC[%VY;Menu]
  281.  
  282. OPERATION
  283. Say your online and the script is scanning for new files, hit <TAB> and
  284. then <S>croll-back buffer to view files or what ever, hit ESC to get out
  285. of scroll back buffer and at the MENU hit "R" to resume where you were
  286. before.
  287.  
  288. MENU
  289. <C> = find main Command
  290. I removed this from the menu for space reasons but the command is active.
  291.  
  292.  <D> = Download a file
  293.  <DM>= Download Mail (from mail door)
  294. *<E> = Edit Script
  295. *<F> = File Manager
  296.  <G> = Goodbye
  297. *<J> = Jump to DOS
  298. *<L> = Log to disk ...status %LD
  299.  <M> = Mail (check for your mail)
  300.  <N> = New File Scan
  301.  <O> = Open Door
  302. *<P> = edit Phone directory
  303. *<Q> = Quick Note file
  304.  <R> = RESUME Script
  305. *<S> = Scroll-back buffer
  306.  <T> = Terminal Mode
  307.  <U> = Upload a file
  308.  <UM>= Upload Mail (from mail door)
  309.  
  310. * commands will return you to the menu
  311. Other commands will return you to the script/terminal mode
  312.  
  313. The commands on the menu will issue the block commands or line commands
  314. for NORMAL board operations...  I know that there are some sysops in there
  315. infinite wisdom who will insist that this command HAS to be.......  but
  316. they should work (95%) of the time
  317.  
  318. RESUME
  319. When using the resume command, it should work as long as the command to
  320. \eb (end the block) wasn't executed.  Smart script is a term that I am
  321. using for this operation.  What happens upon every completion of a block,
  322. it is flagged so that the script knows that the commands have already been
  323. completed.  So when you restart the script, it will start at the first
  324. block that was NOT completed.  This should work for all of the blocks
  325. except for the mail blocks.  Terminating within the door is fine, and
  326. resuming at the Command prompt is fine, but you can NOT reSTART the script
  327. in the process of getting mail.  The commands would reStart the download
  328. or the upload blocks of the script.
  329.  
  330. If a block has already been completed, the menu option for the command
  331. will call up the block and re-execute the commands again.
  332.  
  333. The View settings window allow you to see your settings, just some things
  334. else to play with.....
  335.  
  336. Manual Macro command is for anything that you might come up with.  You
  337. could use it to reset the \gv[] command while the script is running.
  338.  
  339.  
  340.     * * * *   File Transfers Uploading and downloading   * * * *
  341.  
  342. I have improved upon to interface for transferring files both uploading
  343. and downloading.  You can still do the file transfers exactly as before if
  344. you like, but I think that once you have tried the new approach that you
  345. will no longer have any interest in the older method.
  346.  
  347. This idea all started with Dan Potvin, who brought Martin Vallevand (author
  348. of BBSee in) with the idea of multi file downloading/uploading with the aid
  349. of BBSee.
  350.  
  351. File downloading:
  352.  
  353.    To download files, you need to create a file list that is the same name
  354. as the script that will be used in the dialing directory.  This file needs
  355. to reside in the script directory.  For downloading, the filename format
  356. can be either liner (80 characters max) or in a column format. IE:
  357.  
  358. edshome.dow   - download file name
  359. boyan5a.zip
  360. boyan5b.zip
  361. boydoc50.zip
  362. hostbbs2.zip
  363. boymk5d.zip
  364.  
  365. or
  366.  
  367. boyan51a.zip boyan51b.zip boydoc51.zip 
  368.  
  369. Once the files have been downloaded the file will be renamed, so that the
  370. next time that you call the system it will not attempt to repeat the
  371. process, or if there is a problem you will still have your list.
  372.  
  373. All of the above can also be done with BBSee, using the file tag option.
  374. This will make the file and place all of the filenames in it.
  375.  
  376. File Uploading.
  377.  
  378. File uploading is just as simple, only you have some guidelines to follow.
  379. For a single file upload follow this format.
  380.  
  381. edshome.up
  382. first  line :filename
  383. second line : description one   (42 characters max)
  384. third  line : description two   (42 characters max)
  385. fourth line : description three (42 characters max) only three lines!
  386.  
  387. For more than one upload, follow this format
  388.  
  389. first  line :filename
  390. second line : description one   (42 characters max)
  391. third  line : description two   (42 characters max)
  392. fourth line : description three (42 characters max) only three lines!
  393. +    Must contain a plus for additional uploads
  394.  
  395. IE: Sample
  396.  
  397. scsidiag.zip
  398. Diagnostics utility for SCSI hard drives
  399. +
  400. fondir57.zip
  401. Phone convert program, supports most
  402. current comm programs.
  403. +
  404. scout54.zip
  405. Scout 5.4 file manager TRS with Hot Key
  406. +
  407. HYDK430.ZIP
  408. Hyperdisk v4.30 Disk Cache
  409. +
  410. LIST76E.ZIP
  411. LIST version 7.6E
  412. +
  413. SCANV85.ZIP
  414. The latest update in the McAfee's series of
  415. virus detection.
  416. +
  417. CLEAN85.ZIP
  418. Clean85.zip  to go along with scan 85
  419.  
  420. Notes:
  421.  
  422. I used the \GV[] macro command in the script.bsc.  PLEASE realize this
  423. concept!  If you call a system and abort the script, the \GV command opens
  424. a file.  The file stays open until the command is called to close it or
  425. that a new \gv[] command is executed.  If you abort the script and try a
  426. again, when the next \GV command is called, it will grab the next filename
  427. and description.  If see the wrong filename being shown on the remote
  428. systems end THIS IS WHY.  You can correct the problem by issuing the
  429. manual macro command Alt-M and enter \gv[].
  430.  
  431.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  432. Please HELP OUT.  If you are using these scripts and are having problems
  433. with them, I would like to know about them.  I try to make these so that
  434. they will work on every system (sysop) who gets in our way..... <g>.
  435. I can be reached in any Boyan conference that you can find.  I can be
  436. FAXed as (301)805-7168 from voice mail hit 22#.  BBS 301-805-1602
  437.  
  438.  Lee Breeden
  439.  
  440.   ■ On Monday ■ December 16, 1991 ■ at 11:40 pm ■ from Bowie Md ■
  441.